Call-Home Profile Configuration Mode

Call-Home Profile Configuration Mode
 
 
The Call-Home Profile Configuration Mode is used to create groups of users that will receive alerts when events occur. The Smart Call Home service sends real-time alerts, remediation, and personalized web-based reports to the Technical Assistance Center (TAC) and the configured profiles.
 
 
active
Use this command to activate the current call-home profile.
Product
All
Privilege
Security Administrator, Administrator
Syntax
active
default active
no active
default
Configures the call-home profile back to default settings. By default, the profile is enabled.
no
Deletes the call-home profile.
Usage
Use this command to activate the current call-home profile. By default, the profile is enabled.
Example
The following command disables the call-home profile:
no active
 
destination
Use this command to configure the messages destinations for the call-home profile.
Product
All
Privilege
Security Administrator, Administrator
Syntax
destination [ address [ email email_address | http http_url ] | message-size-limit size | preferred-msg-format [ long-text | short-text | xml ] | transport-method [ email email_address | http http_url] ]
default destination [ message-size-limit | preferred-msg-format | transport-method ]
no destination [ address [ email email_address | http http_url ] | message-size-limit size | preferred-msg-format [ long-text |short-text | xml ] | transport-method [ email email_address | http http_url ] ]
address [ email email_address | http http_url ]
Configures an destination email address or HTTP URL where short-text/long-text call-home message and XML-based call-home message will be sent.
•
email: Use this option to add an email address to this profile.
•
http: Use this option to add an http URL address to this profile.
default
Configures the call-home profile back to default settings. By default, the profile is enabled.
message-size-limit size
Specifies the message size for this profile. The default is 3MB.
no
Deletes the call-home profile.
preferred-msg-format [ long-text | short-text | xml]
Specifies the message format for the profile. The default is xml.
•
long-text: Use this option to set long-text messages as the preferred message format. The long message format has all the details related to event, including information related to chassis, card, and show commands outputs for the alert group.
•
short-text: Use this option to set short-text messages as the preferred message format. The short message has information on severity of event, a short description of the event, the event time, and the device ID.
•
xml: Use this option to set XML as the preferred message format. (Default)
transport-method [ email email_address | http http_url] ]
Specifies the transport-method for the messages. The default is email. For the user profile, both email and http can be enabled. If all are options are disabled, email will be set for the profile.
For the Cisco TAC profile, only one transport method can be enabled. If the user enables a second transport method, the first one will be automatically disabled.
•
email: Use this option to enable an email address for this profile. This is the default.
•
http: Use this option to enable an http URL address for this profile.
Usage
Use this command to activate the current call-home profile. By default, the profile is enabled.
Example
The following command disables the call-home profile:
no destination
The following command sets the preferred message format for the profile to the call-home profile to short text:
destination preferred-msg-format short-text
 
end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to return to the Exec mode.
 
exit
Exits the current mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
 
subscribe-to-alert-group
Use this command to subscribe to the alert group for the call-home profile.
Product
All
Privilege
Security Administrator, Administrator
Syntax
subscribe-to-alert-group [ all {severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | configuration { periodic [ daily | monthly | weekly] } | crashinfo | diagnostic { severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | environment { severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | inventory { periodic [ daily | monthly | weekly] } | syslog {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } ]
default subscribe-to-alert-group
no subscribe-to-alert-group [ all {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | configuration { periodic [ daily | monthly | weekly] } | crashinfo | diagnostic {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | environment {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] } | inventory { periodic [ daily | monthly | weekly] } | syslog {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] [pattern pattern_to_match] } ]
all {severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }
Enables call-home messages based for all group-types and severity for the profile. The following severities are supported:
•
catastrophic: Level 1: catastrophic event, matches asr5k logging level critical.
•
disaster: Level 2: disaster event, matches asr5k logging level critical.
•
fatal: Level 3: fatal event, matches asr5k logging level critical.
•
critical: Level 4: critical event, matches asr5k logging level critical.
•
major: Level 5: major event, matches asr5k logging level error.
•
minor: Level 6: minor event, matches asr5k logging level warning.
•
warning: Level 7: warning event, matches asr5k logging level warning.
•
notification: Level 8: notification event, matches asr5k logging level unusual.
•
normal: Level 9: normal event, matches asr5k logging level info.
configuration { periodic [ daily | monthly | weekly] }
Enables call-home messages based for configuration alert groups. The messages are sent at periodic intervals such as:
•
daily: sends a daily call-home message.
•
monthly: sends a monthly call-home message.
•
weekly: sends a weekly call-home message.
crashinfo
Configures the call-home profile back to default settings. By default, the profile is enabled.
default
Restores the parameter back to the default value.
diagnostic { severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }
Enables call-home messages based for diagostic group-types and severity for the profile. The following severities are supported:
•
catastrophic: Level 1: catastrophic event, matches asr5k logging level critical.
•
disaster: Level 2: disaster event, matches asr5k logging level critical.
•
fatal: Level 3: fatal event, matches asr5k logging level critical.
•
critical: Level 4: critical event, matches asr5k logging level critical.
•
major: Level 5: major event, matches asr5k logging level error.
•
minor: Level 6: minor event, matches asr5k logging level warning.
•
warning: Level 7: warning event, matches asr5k logging level warning.
•
notification: Level 8: notification event, matches asr5k logging level unusual.
•
normal: Level 9: normal event, matches asr5k logging level info.
environment {severity [ catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] }
Enables call-home messages based for environment group-types and severity for the profile. The following severities are supported:
•
catastrophic: Level 1: catastrophic event, matches asr5k logging level critical.
•
disaster: Level 2: disaster event, matches asr5k logging level critical.
•
fatal: Level 3: fatal event, matches asr5k logging level critical.
•
critical: Level 4: critical event, matches asr5k logging level critical.
•
major: Level 5: major event, matches asr5k logging level error.
•
minor: Level 6: minor event, matches asr5k logging level warning.
•
warning: Level 7: warning event, matches asr5k logging level warning.
•
notification: Level 8: notification event, matches asr5k logging level unusual.
•
normal: Level 9: normal event, matches asr5k logging level info.
inventory { periodic [ daily | monthly | weekly ] }
Enables call-home messages based for inventory alert groups. The messages are sent at periodic intervals such as:
•
daily: sends a daily call-home message.
•
monthly: sends a monthly call-home message.
•
weekly: sends a weekly call-home message.
no
Deletes the alert groups.
syslog { severity [catastrophic | diasaster | fatal | critical | major | minor | warning | notification | normal ] [ pattern pattern_to_match] } ]
Enables and disables call-home messages based on severity and syslog string pattern match for the profile. The following severities are supported:
•
catastrophic: Level 1: catastrophic event, matches asr5k logging level critical.
•
disaster: Level 2: disaster event, matches asr5k logging level critical.
•
fatal: Level 3: fatal event, matches asr5k logging level critical.
•
critical: Level 4: critical event, matches asr5k logging level critical.
•
major: Level 5: major event, matches asr5k logging level error.
•
minor: Level 6: minor event, matches asr5k logging level warning.
•
warning: Level 7: warning event, matches asr5k logging level warning.
•
notification: Level 8: notification event, matches asr5k logging level unusual.
•
normal: Level 9: normal event, matches asr5k logging level info.
pattern_to_match is a string from 1-80.
 
Usage
Use this command to enable or disable the call-home messages based on specified alert-groups and severities for the profile.
Example
The following command sets an alert group for the profile to send a daily inventory message:
subscribe-to-alert-group inventory periodic daily
 
 
Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883